Binding

Inside Macintosh: OpenDoc Class Reference / Part 2 - Types and Constants

Binding
This section describes the types and constants used during the process of binding a part to a part editor.

Editors and Viewers
The following type and constant represent the shared libraries that implement OpenDoc part editors.

ODEditor
An opaque, platform-specific type identifying a part editor.
Constants of this type

kODNoEditor
A null OpenDoc editor.

The following constants of type ODISOStr (page 875) relate to part editors and part viewers.

kODBlackBoxHandlerOfLastResort
The editor ID for the editor of last resort, which is used for any part for which a suitable editor cannot be found.
kODSimpleViewer
The viewer type for a simple part viewer.

Name-Mapping Resources
The following constants of type ODISOStr (page 875) identify the name-mapping ('nmap') resources that a part editor uses to describe the kinds of data it can edit. OpenDoc uses these resources to construct the specified tables. Constants marked [M] are specific to the Mac OS platform.

kODCategoryUserString
A table that maps a part category to a user-visible string naming that category.
kODContainerSuite
A table that maps a container type to the container suite ID for that type.
kODEditorHelpFile
A table that maps an editor ID to the name of that editor's help file.
kODEditorKinds
A table that maps an editor ID to the part kinds that the editor supports.
kODEditorPlatformKind [M]
A table that maps an editor ID to the standard Mac OS kinds that the editor can edit. The table identifies each standard kind with four parts: a platform type space (either file or data), the Mac OS file type, a user-visible string naming the type, and the category that the type belongs to.
kODEditorUserString
A table that maps an editor ID to a user-visible string naming that editor.
kODKind
A table that maps a part kind to the categories that the kind belongs to.
kODKindOldMacOSType [M]
A table that maps a new OpenDoc kind to the old Mac OS file type for that kind.
kODKindUserString
A table that maps a part kind to a user-visible string naming that kind.
kODViewer
A table that maps a part viewer ID to the viewer type. Currently, the only supported viewer type is kODSimpleViewer.

Part Categories
The following constants of the ODISOStr type (page 875) are used to identify part categories in the name-mapping ('nmap') resources. A part category is a general classification of the format of data handled by a part editor.

kODCategoryCalendar
Calendar data.
kODCategoryChart
Chart data.
kODCategoryCompressed
Compressed data, such as in .sit or .cpt format.
kODCategoryConnection
Connection data, such as the CommToolBox Connection Tool preferences format.
kODCategoryControl
Controls, such as a button.
kODCategoryControlPanel
Control panels, such as Editor Setup.
kODCategoryDatabase
Databases, such as in FileMaker format.
kODCategoryDrawing
Drawing data, such as in PICT or MacDraw format.
kODCategoryExecutable
Executable data, such as in .COM, .EXE, or other executable format.
kODCategoryForm
Form data.
kODCategoryFormula
Formula data, such as in an equation-editor format.
kODCategoryKey
Key data, such as an AppleShare password or a PGP key.
kODCategoryLocator
Locator data, such as a URL.
kODCategoryMailingLabel
Mailing labels, such as for a PowerTalk mailer.
kODCategoryOutline
Document-outline data.
kODCategoryMovie
Movie data, such as in QuickTime format.
kODCategoryPageLayout
Page-layout data.
kODCategoryPainting
Painting data, such as in TIFF or MacPaint format.
kODCategoryPersonalInfo
Personal information, such as on business cards.
kODCategoryPlainText
Plain text, such as in ASCII or Apple Standard Roman.
kODCategoryPresentation
Presentation data.
kODCategoryPrinter
Printer data.
kODCategoryProject
Project-management data, such as in MacProject format.
kODCategoryQuery
Database queries, such as in SQL format.
kODCategorySampledSound
Sampled sounds, such as in the 'snd' format.
kODCategoryScript
Scripting data, such as in HyperTalk, AppleScript, or any other OSA-compliant scripting-language format.
kODCategorySignature
Digital-signature data, such as a PowerTalk signature.
kODCategorySpace
Space data, such as a folder, hard disk, or server.
kODCategorySpreadsheet
Spreadsheet data, such as in SYLK format.
kODCategoryStructuredSound
Structured sound, such as in MIDI format.
kODCategoryStyledText
Styled text, such as in 'styl' or MacWrite II format.
kODCategory3DGraphic
3D graphics data, such as in QuickTime VR format.
kODCategoryTable
Tables, such as in tab-delimited text format.
kODCategoryTime
Data related to time, for example, data used by clock parts.
kODCategoryUtility
Data used by miscellaneous utilities.

Data Types in Resources
The following constants of type ODISOStr (page 875) identify the various data types used in the name-mapping ('nmap') resources. Constants marked [M] are specific to the Mac OS platform.

kODIsAnISOStringID
An ISO string.
kODIsAnISOStringListID
A list of ISO strings.
kODIsINTLTextID
International text structure.
kODIsMacOSTypeID [M]
A file type specified with the Mac OS type OSType.
kODIsPltfrmTypeSpacID
A platform type space (file or data).
kODIsHelpFileNameID
A help file-name.